home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / LEGROOM.ARJ / README.1ST < prev    next >
Text File  |  1992-05-23  |  17KB  |  431 lines
  1.                     
  2.       ╔═════════════════════════════════════════════════════════╗
  3.       ║ THIS DOCUMENTATION GOES WITH VERSION 1.0 OF LEGROOM(tm) ║
  4.       ╚═════════════════════════════════════════════════════════╝
  5.  
  6.                     
  7.                     TABLE OF CONTENTS                       
  8.                     ─────────────────
  9.  
  10. 1. SHAREWARE CONCEPT
  11.  
  12. 2. ACKNOWLEDGMENTS
  13.  
  14. 3. PACKING LIST
  15.  
  16. 4. WHAT IS LEGROOM?
  17.  
  18. 5. HOW TO USE LEGROOM
  19.  
  20. 6. USAGE NOTES
  21.  
  22. 7. DISCLAIMER
  23.  
  24. 8. DISTRIBUTION POLICY AND LICENSE
  25.  
  26. 9. ON-LINE, HYPERTEXT VERSION OF THIS README DOCUMENT
  27.  
  28.  
  29. 1. SHAREWARE CONCEPT
  30. ────────────────────
  31.  
  32. "Shareware" is a term used to describe a system for distribution of
  33. software.  Under the shareware concept, software may be freely
  34. copied and passed along to others, or distributed through bulletin
  35. board systems, shareware distribution companies, etc.
  36.  
  37. As a recipient of a shareware program, you may use the software for
  38. a short trial period to determine if it meets your needs.  If it
  39. does, you pay the registration fee.  By paying the fee, you are
  40. granted the right to retain the software for your use.  If the
  41. software is not suitable, then you may discard it.
  42.  
  43. The shareware system provides substantial benefits to the computing
  44. community (of which YOU are a member):
  45.  
  46.  
  47.  a) You get to try out the software BEFORE you buy it so you know
  48.     exactly what you're buying.
  49.  
  50.  b) Shareware is substantially less expensive than most commercial
  51.     programs.  You don't pay for costly marketing programs and
  52.     fancy packaging.
  53.  
  54.  c) You get access to a MUCH broader base of available programs.
  55.     Thousands of excellent programs have been written by expert
  56.     programmers who would never consider marketing commercially.
  57.  
  58. Through the concept of shareware, these people make their
  59. programs available to the community.  Usually, all they ask in
  60. return is a small fee to reward them for the time and effort
  61. they've put into the program.
  62.  
  63. The system is based entirely on the honor system, and generally
  64. works quite well.  (Most people are honest and wouldn't violate the
  65. trust placed in them by the author of the software.)
  66.  
  67. Shareware is NOT free software - the author counts on your
  68. integrity. Please register using the form in the file REGISTER.FRM.
  69.  
  70. You are encouraged to copy this software and pass it along to
  71. others who may be interested in using it.
  72.  
  73. In exchange for registering your copy of LegRoom(tm), you will
  74. receive the current version without the registration reminder and
  75. the next version of LegRoom (tm) when it is available.
  76.  
  77. In addition, you will receive a listing of other Ivden products.
  78.  
  79.  
  80. 2. ACKNOWLEDGMENTS
  81. ──────────────────
  82.  
  83. LegRoom(tm) was developed by Phil Grenetz and is published by
  84. Ivden Technologies, Inc. as part of a line of memory resident
  85. utilities.
  86.  
  87.                (c) Copyright 1992 Phil Grenetz
  88.  
  89. The hypertext documentation was developed using the authoring system 
  90. DeskTop Advisor(tm), also published by Ivden Technologies, Inc.
  91.  
  92.  
  93. 3. PACKING LIST
  94. ───────────────
  95.  
  96. LEGROOM.EXE         Executable File
  97. REGISTER.FRM        Registration Form
  98. README.1ST          Conventional Documentation File
  99. DA-BROWS.EXE        DeskTop Advisor (DA) Hypertext Documentation Browser
  100. DA_1.HLP            DA help file
  101. DA_2.HLP            "   "    "
  102. DA_3.HLP            "   "    "
  103. LR_KB.DTA           Hypertext Documentation File
  104. LR_KB.MAP                "         "         "
  105. LR_KB.WDX                "         "         "
  106. LR_KB.XRF                "         "         "
  107. LR_KB.WLK                "         "         "
  108. LR_KB.TWX                "         "         "
  109. LR_KB.CWD                "         "         "
  110.  
  111.  
  112. 4. WHAT IS LEGROOM?
  113. ───────────────────
  114.  
  115. LegRoom(tm) is published by Ivden Technologies, Inc. as part of its
  116. line of memory resident utilities.  LegRoom was designed to solve
  117. two problems:
  118.  
  119.  a) shelling to DOS from applications that don't have a DOS shell
  120.     function
  121.  
  122.  b) shelling from applications which have a shell function, but
  123.     give too little memory at the DOS prompt to do any useful work.
  124.  
  125. LegRoom(tm) allows you to Shell to DOS from any text and most
  126. graphic  applications.  It loads as a TSR (Terminate and Stay
  127. Resident) program and is triggered when you press a hot key.
  128.  
  129.  
  130. 5. HOW TO USE LEGROOM
  131. ─────────────────────
  132.  
  133. LegRoom(tm) runs on any IBM compatible computer running MS-DOS,
  134. Version 2.0 and up, or 100% compatible operating system.
  135.  
  136. Load LegRoom(tm) by changing to the directory where you installed it 
  137. and entering the command:  LEGROOM.  You can also add that command to 
  138. your AUTOEXEC.BAT file to load LEGROOM whenever you boot your computer.  
  139. That way, it will stay in memory for use whenever you need it.
  140.  
  141. LegRoom(tm) auto-detects the presence of extended and expanded
  142. memory and takes advantage of them.  If available, it loads itself
  143. into expanded memory.  It keeps only a small 'stub' in conventional
  144. memory, about 1.5 KB in size.
  145.  
  146. When you press the hot key, the current application is suspended.
  147. It is moved to a holding area in extended memory, expanded memory,
  148. or your hard disk, depending on which is available.  The program, its
  149. data, video memory, and mouse state are saved, as are your current 
  150. drive and directory.
  151.  
  152. When you are finished running other programs, type EXIT to return to
  153. the suspended application.  Its state is restored to that saved prior 
  154. to pressing the hot key.
  155.  
  156. You needn't have an expanded memory board to have expanded memory.
  157. Memory managers such as EMM386, QEMM386, and 386MAX emulate
  158. expanded memory for applications which call for it.
  159.  
  160. There are three command line parameters you can use to control the
  161. behavior of LegRoom(tm).  These parameters are described below:
  162.  
  163.           LEGROOM  [/D | /N]  [/Hn]  [/U]  [/?],
  164. where:
  165.        /D  creates a disk file (LEGROOM.$$$) for holding the current
  166.            application, instead of using extended or expanded memory;
  167.  
  168.        /N  uses extended memory, if available, for holding the
  169.            current application, but DOES NOT use expanded memory;
  170.            this makes it run compatibly with QEMM in 'stealth' mode;
  171.  
  172.        /Hn changes the default hot key from Ctrl-Shift-0 to
  173.            Ctrl-Shift-n, where n is between 0 and 9;
  174.  
  175.        /U  unloads LegRoom(tm) from memory;
  176.  
  177.        /?  displays help information without loading LegRoom(tm).
  178.  
  179. To trigger LegRoom(tm), press the default hot key or the hot key
  180. you requested if you used the /Hn parameter as described above.
  181. Use the standard number keys on your keyboard, NOT the numeric
  182. keypad.
  183.  
  184. To unload LegRoom(tm) from memory, enter the command LEGROOM /U from 
  185. the DOS prompt.  LegRoom(tm) will not allow you to unload it when you 
  186. have shelled to DOS using it.
  187.  
  188.  
  189. 6. USAGE NOTES
  190. ──────────────
  191.  
  192. You cannot load LegRoom(tm) into upper memory with the load high
  193. facilities of a memory manager.  This is a minor limitation, since
  194. a 386 based memory manager can load LegRoom(tm) into expanded
  195. memory, leaving a very small piece of the program in conventional
  196. memory.
  197.  
  198. Ctrl-Break is disabled at the new DOS prompt after triggering
  199. LegRoom(tm).  Use Ctrl-C instead of Ctrl-Break to break out of a
  200. process launched from the new DOS prompt.
  201.  
  202. DON'T SHELL FROM A SHELL!  You cannot trigger LegRoom(tm) when at
  203. the DOS prompt.  This would be a waste of memory or disk space.
  204. However, LegRoom(tm) does not detect the presence of a DOS prompt
  205. created by using an application's built-in shell feature.  Use one
  206. or the other, but not both.
  207.  
  208. You can use LegRoom(tm) from multitasking environments such as
  209. DesqView and Microsoft Windows.  But, these environments provide the 
  210. facilities for creating a DOS environment and entering it at will.  
  211. The advantages of LegRoom(tm) are greatest in a single tasking DOS 
  212. environment.
  213.  
  214. Do not use LegRoom(tm) to shell from a communication program while 
  215. transferring data.  Shelling with LegRoom(tm) suspends the current 
  216. application.  It does not keep running in the background.  Data will 
  217. be lost if you use LegRoom(tm) to shell to DOS while performing a
  218. file transfer.
  219.  
  220. You should, in general, not load a TSR into memory when you have 
  221. shelled to DOS from an application.  When you exit the application, 
  222. you will have a 'hole' in your conventional memory pool where the 
  223. application was.  This is called fragmentation.  It reduces the 
  224. largest block of memory available to programs.  This applies whether 
  225. you are shelling with LegRoom(tm) or using the DOS shell feature of 
  226. an application.
  227.  
  228. If it is necessary for LegRoom(tm) to use swap files, they are 
  229. maintained in a subdirectory named 'temp' under the directory where 
  230. you installed LegRoom(tm).  They are stored with System and Read-Only 
  231. attributes to reduce the risk of inadvertent deletion or renaming 
  232. while LegRoom(tm) is loaded.
  233.  
  234. LegRoom(tm) supports any number of concurrent users on a network.  A 
  235. unique name is assigned to each user's swap file in the 'temp' 
  236. subdirectory to avoid 'collisions'.  
  237.  
  238. Rebooting or turning off the computer without first unloading 
  239. LegRoom(tm) results in old swap files in the 'temp' subdirectory.  
  240. Old swap files are removed automatically when LegRoom(tm) is loaded.  
  241. Old swap files are those which have been on the network for more 
  242. than two days.
  243.  
  244. LegRoom(tm) supports all standard graphic modes and Super VGA modes
  245. up to a maximum video memory requirement of 256 KB.
  246.  
  247.  
  248. 7. DISCLAIMER
  249. ─────────────
  250.  
  251. IVDEN TECHNOLOGIES, INC. (IVDEN) HEREBY DISCLAIMS ALL WARRANTIES
  252. RELATING TO THIS SOFTWARE, WHETHER EXPRESS OR IMPLIED, INCLUDING
  253. WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
  254. FITNESS FOR A PARTICULAR PURPOSE. IVDEN WILL NOT BE LIABLE FOR ANY
  255. SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES DUE
  256. TO LOSS OF DATA OR ANY OTHER REASON, EVEN IF IVDEN OR AN AGENT OF
  257. IVDEN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  IN NO
  258. EVENT SHALL IVDEN'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE
  259. PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF
  260. THE CLAIM.  THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE
  261. QUALITY AND PERFORMANCE OF THE SOFTWARE.
  262.  
  263.  
  264. 8. DISTRIBUTION POLICY AND LICENSE
  265. ──────────────────────────────────
  266.  
  267. Distribution Policy
  268. ───────────────────
  269.  
  270. Bulletin boards and non-profit user groups may include this software 
  271. in their libraries.  LegRoom(tm) is shareware and may be copied or
  272. posted for downloading for trial usage by others subject to the
  273. following conditions:
  274.  
  275. 1) All files must be distributed together in original, unmodified
  276.    form as ORIGINALLY NAMED.
  277.  
  278. 2) NO files may be added to the archive.
  279.  
  280.  
  281. For-profit distributors of shareware may distribute it subject to
  282. the following conditions, in addition to conditions 1) and 2)
  283. above:
  284.  
  285. 1) Information is provided, in catalogs and point-of-purchase
  286.    displays, making it clear that this software is distributed
  287.    under the SHAREWARE concept and that the user has NOT paid for
  288.    the software.  Users are urged to support the software by
  289.    registering.
  290.  
  291. 2) The cost per disk charged for distribution cannot exceed
  292.    $15.00.
  293.  
  294. 3) Ivden Technologies, Inc. is notified in writing within 30 days
  295.    of adding it to the list of products carried (so we know who is
  296.    distributing LegRoom(tm) and can keep distributors up to date).
  297.  
  298. 4) Distribution is terminated immediately on written request from
  299.    Ivden Technologies, Inc.
  300.  
  301. 5) The product name and trademark symbol must be properly used and
  302.    displayed as shown here:
  303.                                          tm
  304.               LegRoom(tm)    or    LegRoom
  305.  
  306. 6) All customer complaints and/or problem reports are referred to us 
  307.    at:
  308.  
  309.    Ivden Technologies, Inc.             (215) 328-1145
  310.    87 Arbor Road                        CompuServe ID: 71221, 3602
  311.    Churchville, PA 18966-1007
  312.  
  313.  
  314. License to Use LegRoom(tm)
  315. ──────────────────────────
  316.  
  317. LegRoom(tm) is a copyrighted software package. It is being 
  318. distributed as user supported shareware. By using or distributing 
  319. this package, you agree to the following:
  320.  
  321. You are granted a limited license to try this program, LegRoom(tm),
  322. for 30 days. If you find this software useful and wish to continue 
  323. using it after the 30 day evaluation period, you must pay the 
  324. registration fee.  Registration for use on a single personal computer 
  325. is $19.95.  You may, instead, register for installation on a local 
  326. area network (LAN) server.  The LAN registration fee of $99 permits 
  327. an unlimited number of concurrent users on the registered server.
  328.  
  329. Register for each personal computer and each LAN server on which 
  330. LegRoom(tm) is installed.  To register, fill out the registration 
  331. form (see REGISTER.FRM) and send it or a note with the registration 
  332. fee.
  333.  
  334. No other license or rights are granted by implication or otherwise.
  335. After evaluating LegRoom(tm), if you continue to use it, you MUST
  336. register.
  337.  
  338. NOTE TO DEVELOPERS:
  339. If you would like to seamlessly integrate the LegRoom(tm) technology
  340. into programs you distribute for profit, Ivden Technologies, Inc.
  341. maintains an interrupt-triggered version.  The developer version of
  342. LegRoom(tm) loads in advance of your program and resides in memory
  343. as an interrupt service routine dedicated to your program(s).  You 
  344. just call a specified interrupt and the DOS shell is triggered.  
  345.  
  346. No saving / restoring your screen.  No worrying about how little 
  347. memory will available at the DOS prompt.  LegRoom(tm) takes care 
  348. of everything.  No link libraries to bother with.  No memory models 
  349. or compatibility issues to hassle with.  Any language which has an 
  350. interrupt call function is supported.
  351.  
  352. Contact Ivden Technologies, Inc. for our very reasonable runtime 
  353. license fee.
  354.  
  355.  
  356. 9. ON-LINE, HYPERTEXT VERSION OF THIS README DOCUMENT
  357. ─────────────────────────────────────────────────────
  358.  
  359. A hypertext Readme document is also provided with this package.
  360. It was created using another Ivden product, DeskTop Advisor(tm), 
  361. a hypertext document authoring system.
  362.  
  363. In DeskTop Advisor(tm), information is organized in topics.  From any
  364. topic, you can select other topics to explore by pressing Alt-T.
  365.  
  366. To browse the DeskTop Advisor(tm) documentation, change to the directory 
  367. on the disk where you installed LegRoom(tm).  Then enter the command:  
  368.                   
  369.                         DA-BROWS
  370.  
  371. from the DOS prompt.  The system will guide you from there.  It is 
  372. menu-driven and does not require a mouse.
  373.  
  374. Every time you visit a new topic, a bookmark is placed at the current
  375. topic.  No matter how deeply you go into the guide, you can retrace
  376. your steps, one topic at a time by pressing Ctrl-PgUp or pressing
  377. Alt-T and selecting ** PREVIOUS TOPIC **.  To return to the beginning
  378. of this document from any topic, press Ctrl-Home or press Alt-T and
  379. select ** INTRODUCTION **.
  380.  
  381.  
  382. The Master Topic Index
  383. ──────────────────────
  384.  
  385. You are not limited to using Alt-T for topic selection.  You can
  386. access any topic wherever you are in the document.
  387.  
  388. From any topic, you can view the master index of topics by pressing
  389. the Space Bar.  Next, using the PgUp, PgDn, arrow keys, and keys
  390. for the first letter of a topic, you can highlight a topic of
  391. interest.  Then, press Enter to proceed to the selected topic.
  392.  
  393. As always, you can return to the previously visited topic by pressing
  394. Ctrl-PgUp or pressing Alt-T and selecting ** PREVIOUS TOPIC **.
  395.  
  396.  
  397. Using Key Words
  398. ───────────────
  399.  
  400. On any screen there may be key words about which you would like to
  401. get more information.  By pressing the Tab key, you will make all
  402. such words appear highlighted.  The first key word on the screen is
  403. blinking, indicating it is currently selected.
  404.  
  405. You can highlight a key word in which you are interested by using
  406. the Tab, Home, and End keys.  Press Enter and a menu of topics
  407. which reference the key word appears.  Select a topic which seems
  408. to be relevant to your needs.  That topic will pop up in a window.
  409. Use the up and down arrow keys to view each page on which the word
  410. is used.
  411.  
  412. When finished viewing the selected topic, return to the underlying
  413. topic by pressing Ctrl-PgUp.  Select another related topic to
  414. explore or press ESCape to return to the underlying screen.
  415.  
  416. DeskTop Advisor(tm) has a few other features, not included here, such
  417. as graphic images and sound overlays.  Sound Support(tm), a recorded 
  418. voice supplement to the standard help screens, is also included with 
  419. the product.  In addition, a DeskTop Advisor(tm) document can be made
  420. memory resident, to be triggered by a hot key as needed.
  421.  
  422. That's all there is to it!  We know LegRoom(tm) is so easy to use it 
  423. doesn't really need hypertext documentation.  But, we want as many 
  424. computer users as possible to be exposed to the concept.  We hope to make 
  425. DeskTop Advisor(tm) a standard tool for publishing on-line documentation 
  426. for software.  Thanks for trying it.  Your feedback is requested.
  427.  
  428. Of course, we hope you find that LegRoom(tm) makes your DOS environment
  429. more productive.  If you like the product, please register it.  If you
  430. have comments -- positive or negative -- please share them with us.
  431.